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(54) Multi-service communication system and method 



(57) A multi-service communication system and 
method is disclosed which permits the integration of tra- 
ditional PSTN functions and voice-over- IP/voice-over- 
data (VOIP/VOD) functions within the same communi- 
cation system. The extension of scripting functions to 
support these features in general simultaneously per- 
mits the script to interact with PSTN and IP telephones 
within the context of the same services, to share the 



same service logic for both PSTN and I P media, to con- 
ference participants on both PSTN and IP, to store and 
forward information between the two media, to play on- 
hold media to the interface, and/or to monitor informa- 
tion between the two media. In general the disclosed 
invention is amenable to the integration of PSTN and 
VOIP networks, but other service functions may be in- 
tegrated with no loss of generality. 
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Description 

Field of the invention 

5 [0001] The present invention generally relates to public switched telephone networks (PSTN's) / voice-over- IP te- 
lephony and particularly to the application of the extension of scripts to interact with PSTN and IP telephones within 
the context of the same services. 

Background of the invention 

10 

Overview 

[0002] Today script based services are available to program interactive voice response devices when communicating 
with the public switched telephone network (PSTN). Today IP networks are evolving and voice over IP telephony is 
*5 being used for communication similar to that of PSTN networks. The general problem with this scenario is that there 
is no common bridge to manage services that involved both PSTN and IP end-points in the same connection. 

Description of the prior art 

20 [0003] For example, the IBM IVR platform Direct Talk (reference IBM Direct Talk for AIX, V2, R2: State Tables, 
Prompts and Voice Segments, SC33-1 846, December 1 998) provides the script language used for PSTN interaction. 
In the present invention the script needed for interacting with IP telephones was developed and uses the same script 
method as Direct Talk and can coexist. 

25 Objects of the invention 

[0004] Accordingly, the objects of the present invention are (among others) to circumvent the deficiencies in the prior 
art and affect the following objectives: 

30 1 to extend the script to interact with PSTN and IP telephones within the context of the same services; 

2 to share same service logic for both PSTN and IP media; 

3 to conference participants on both PSTN and IP; 

35 

4 to store and forward information between the two media; 

5 to play ON-HOLD media to with interface; and/or 

40 6 to monitor information between the two media. 

[0005] While these objectives should not be understood to limit the teachings of the present invention, in general 
these objectives are achieved by the disclosed invention that is discussed in the following sections. 

45 Brief summary of the Invention 

Overview 

[0006] Referencing FIG. 1, in the present invention scripts have been extended to interact with PSTN and IP tele- 
phones within the context of the same services. In, the present invention, the scalable PSTN gateway (104, 113, 123, 
1 25) is a gateway that connects calls from a PC-based H .323 client application (1 02, 1 1 5) to the regular PSTN telephone 
system (105, 112, 122, 126). Inbound calls originating from the PSTN are connected through an IP connection (103, 
114, 124) to a PC client application (102, 115). Outbound calls originating from a PC client application are sent through 
the gateway to the PSTN destination. In addition, as illustrated in FIG. 1, Voice Over Data (VOD) may provide an 
55 optional RISC-based solution for routing PSTN calls over a data network, allowing three types of voice connections: 

1 PC-to-phone (100) ; 
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2 phone-to- PC (110); and/or 

3 phone-to-phone (120). 

[0007] The gateway is scalable and has been reduced to practice to support up to 96 simultaneous calls, although 
any number is potentially realizable. The following detailed discussion may serve as a guide for the VOD CS - Voice 
Over Data Custom Server and the SPN256 Port Resource Control Custom Server for VOD (SPRC). These APIs de- 
veloped for the VOD Custom Server serve as extensions to the DT (IBM's Direct Talk Interactive Voice Response 
System), i.e., they receive commands from the DT The Voice over Data custom server along with the DT form the 
basis of the scalabable PSTN Gateway. This Gateway is a multi-service system and server that runs on the AIX oper- 
ating system. While this system uses the AIX operating system, it is not limited to this and can be implemented on 
another operating system. The multi-service system connects to the PSTN network. The multi-service system can also 
work without a telephone call. In addition, the multi-service system can service and IP call independently. 
[0008] The set of exemplary state table APIs documented herein are designed as a DT interface to the actual custom 
server functions which support a gateway capable of sending and receiving voice between a telephone PSTN interface 
card and the IP (Internet Protocol) network. Calls are generally controlled utilizing the H.323 standard. The SPRC is 
responsible for coordinating the SCBus connections between the DTQA (Direct Talk Quad Adapter) and the SPN256, 
managing resources of the SPISI256 cards, allocating and deallocating them to the application. It is integrated with the 
DTTimeslot Manager, which uses Connection Servers to send low-level commands to the adapters sharing the SCBus 
(cable/logic standard for connecting time division multiplexed voice channels). 

[0009] The operation of these APIs is designed especially for the requirements of the DT system, and are limited by 
its restrictions. 

[0010] The VOD Custom Server is one component of a larger, more complex system and, in order to be able to use 
the VOD Custom Server, it is necessary to understand the DT with all its built-in components as well as other custom 
servers, such as Time Slot Manager, and VOD Gate Custom Server. 

Examplary advantages 

[0011] Overall the present invention can in some exemplary embodiments provide one or more of the following 
30 advantages over the prior art. For example the IBM IVR platform Direct Talk (reference IBM Direct Talk for AIX, V2, 
R2: State Tables, Prompts and Voice Segments, SC33-1846, December 1 998) provides the script language used for 
PSTN interaction. In the present invention, the script needed for interacting with IP telephones was developed and 
uses the same script method as Direct Talk and can coexist with this application. A description of those APIs follows. 

35 Brief description of the drawings 

[0012] For a fuller understanding of the advantages provided by the invention, reference should be made to the 
following detailed description together with the accompanying drawings wherein: 

40 FIG. 1 illustrates exemplary system embodiments of the present invention in PC-to-phone, phone-to-PC, and 

phone-to-phone applications; 

FIG. 2 illustrates an exemplary system architecture diagram for the API interfaces supporting the present invention 
teachings; 

45 

FIG. 3 illustrates an exemplary process flowchart for PSTN call processing; 
FIG. 4 illustrates an exemplary process flowchart for IP call processing; 
50 FIG. 5 illustrates an exemplary process flowchart for connecting call processing; 

FIG. 6 illustrates an exemplary process flowchart for handle status notification processing. 
FIG. 7 illustrates an exemplary process flowchart for ON-HOLD call processing; 

55 

FIG. 8 illustrates an exemplary system embodiment showing full integration of VOD and PSTN applications. 
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Description of the presently preferred examplary embodiments 

[001 3] While this invention is susceptible of embodiment in many different forms, there is shown in the drawings and 
will herein be described in detailed preferred embodiment of the invention with the understanding that the present 

s disclosure is to be considered as an exemplification of the principles of the invention and is not intended to limit the 
broad aspect of the invention to the embodiment illustrated. The numerous innovative teachings of the present appli- 
cation will be described with particular reference to the presently preferred embodiments, wherein these innovative 
teachings are advantageously applied to the particular problems of a multi-service communication system and method. 
However, it should be understood that these embodiments are only examples of the many advantageous uses of the 

10 innovative teachings herein. In general, statements made in the specification of the present application do not neces- 
sarily limit any of the various claimed inventions. Moreover, some statements may apply to some inventive features 
but not to others. In general, unless otherwise indicated, singular elements may be in the plural and visa versa with 
no loss of generality 

15 Definitions 

[0014] Throughout the discussion in this document the following definitions will be utilized: 
Application Program Interface (API) 

20 

[0015] The interface (calling conventions) by which an application program accesses operating system and other 
services. An API is defined at source code level and provides a level of abstraction between the application and the 
kernel (or other privileged utilities) to ensure the portability of the code. 

25 £.164 

[001 6] Standard for representing phone numbers and their translation. 
Endpoint 

30 

[0017] A software entity that represents the source and/or sink of voice information. Typically PSTN, network (H. 
323), or a file. 

Gatekeeper 

35 

[0018] A directory server that manages all authentication and name resolving of all users for the H.323. For more 
information, see "Gateway". 

Gateway 

40 

[0019] An interface that connects networks or system of different architecture. For example, a gateway may connect 
your computer to the World Wide Web, or your computer to the PSTN system - as It does in the case of the present 
invention. 

45 GSM 

[0020] Global System for Mobile Communication standardized by ETSI (European Telecommunications Standards 
Institute). A standard for pan-European digital mobile communication. 

so G.723.1 

[0021 ] An ITU standard for voice compression. 

H.323 

55 

[0022] Standard for telephony over I P. 
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Handle 

[0023] A number indicating an item (Endpoint or connection between Endpoints). 

5 Public Switched Telephone Network (PSTN) 

[0024] The collection of interconnected systems operated by the various telephone companies and administrations 
(telcos and PTTs) around the world. Also known as the Plain Old Telephone System (POTS). 

10 SubNetwork ID (SNID) 

[0025] The port through which the call is being connected. This information is provided by other custom servers. 

SPN256 Card 

15 

[0026] IBM Artic960 DSP Resource adapter, RS/6000 feature 2949. Used for Voice Compression and decompression 
between PSTN and I P voice traffic. This particular hardware is exemplary of f u nctionality that may be readily substituted 
by one skilled in the art. 

20 System Blocks / Procedural Steps Not Llm iti ve 

[0027] The present invention may be aptly described In terms of exemplary system block diagrams and procedural 
flowcharts. While these items are sufficient to instruct one of ordinary skill in the art the teachings of the present in- 
vention, they should not be strictly construed as limiting the scope of the present invention. One skilled in the art will 
25 be aware that system block diagrams may be combined and rearranged with no loss of generality, and procedural 
steps may be added or subtracted, and rearranged in order to achieve the same effect with no loss of teaching generality. 
Thus, it should be understood that the present invention as depicted in the attached exemplary system block diagrams 
and procedural flowcharts is for teaching purposes only and may be reworked by one skilled in the art depending on 
the intended target application. 

30 

Synchronous/Asynchronous Process Steps Not Llmitlve 

[0028] The present invention teaches a variety of processes and procedures that may be implemented to achieve 
the overall scope of the invention purpose. These steps may be performed either synchronously or asynchronously. 
35 Thus, the particular order of a given process is not Limitive of the scope of the present invention. 

Personal Computer Not Limitive 

[0029] Throughout the discussion herein there will be examples provided that utilize personal computer (PC) tech- 
no nologies to illustrate the teachings of the present invention. The term 'personal computer 4 should be given a broad 
meaning in this regard, as in general any computing device may be utilized to implement the teachings of the present 
Invention, and the scope of the invention is not limited just to personal computer applications. 

Operating System Not Limitive 

45 

[0030] Additionally, while the present invention may be implemented to advantage using a variety of Microsoft® 
operating systems (including a variety of Windows™ variants), nothing should be construed to limit the scope of the 
invention to these particular software components. In particular, the system and method as taught herein may be widely 
implemented in a variety of systems, some of which may incorporate a graphical user interface. The present invention 
so multi-services system is implemented in IBM'S AIX operating system but It should be understood that other operating 
systems are within the true scope and spirit of the present invention. 

Data Structures Not Llmitlve 

5 5 [0031] The present invention may be embodied in a variety of data structures in some preferred embodiments. How- 
ever, the form of such data structures as described herein is only exemplary. One skilled In the art would quickly realize 
that a wide variety of other data structures could be used equivalently in this application. Therefore, no data structure 
contained herein should be Interpreted as limiting the scope of the present invention. 
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Voice Not Umitive 

[0032] Many preferred embodiments of the present invention will be described in the context of a VOIP application, 
in which voice is transmitted over the IP protocol. However, the teachings of the present invention can be applied to a 
5 wide variety of other audio, video, or mufti-media applications, and thus while the VOIP application is illustrative of the 
teachings of the present invention, it is not Limttive as to the type of information communicated over the communications 
channel. 

Examplary symbolics 

10 

[0033] The present invention may make use of a variety of exemplary input parameters, return codes, and status 
indicators throughout the system as implemented or in pieces of the system as implemented. The following sections 
provide some of the exemplary symbolics and exemplary values as implemented in some preferred embodiments of 
the present invention. One skilled in the art will quickly recognize that the complement of symbolics and their values 
is may be reduced or augmented with no reduction in the scope of teachings of the present invention. 

VOD Return Codes 

[0034] The following table illustrates symbolics for VOD return codes and their exemplary numeric values: 



30 



40 



Error Number 


Code 


Explanation 


0 


VODJ3K 


API successful 


-1 


VOD_ERROR 


General internal error 


-2 


VOD_MORE_DATA 


Needs more space in the buffer 


-5 


VODJLLEGALJHANDLE 


Illegal handle 


-6 


VODJLLEGAL_PARAM 


Illegal parameter 


-7 


VOD_BAD__EP_TYPE 


Illegal Endpoint type 


-8 


VOD_BAD_STATE 


The item is in a wrong state 


-9 


VOD_TRY_AGAIN 


May try again later 


-10 


VOD.BUSY 


Already created or busy doing something 


•11 


VOD_NOT_FOUND 


The item was not found 


-50 


VOD_CANT_OPEN_SOCKET 


Error opening sockets 


-51 


VOD_NO_MORE_RESOURCES 


No more resources 


-60 


VOD_BAD_RESPOND 


Response is not in the correct format (internal error) 


-61 


VOD_RESPOND_ERROR 


Response came with an error 


-62 


VODJTiMEOUT 


Timeout has occurred for the operation 


-70 


VODJJNSUPPORTED 


This feature is not yet supported 


-100 


VOD_NOT_HANDLED 


Message was not handled. 



Coder Capabilities 



[0035] The following table illustrates symbolics for coder capabilities and their exemplary numeric values: 



50 



55 



coder_cap 


Value 


Explanation 


RTS E_COD E R_N ONE 


0 


Indicates the end of 


RTSE_CODER_GSM 


0x0100 


the list. ETSI standard GSM coder 13.2 Kbit/sec. 


RTS E_COD E R_G S M_V Q 


0x0110 


HRL proprietary GSM product (not supported yet). 


RTSE_CODER_G71 1_ULAW 


0x0200 


G.711 U-LAW. 


RTSE__CODER_G71 1 _ALAW 


0X0210 


G.711 A-LAW. 


RTSE_CODER_G723 


0x0300 


G.723.1 in 6.4 Kbit/sec. 


RTSE_CODER_G723_64 


0x0310 


G.723.1 in 6.4 Kbit/sec, 


RTSE_CODER_G723_53 


0x0320 


G.723.1 in 5.3 Kbit/sec (not supported yet). 


RTSE_CODER_G729A 


0x0400 


G.729 annex A (not supported yet). 
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[0036] The following table illustrates symbolics for possible answers to the VOD_Net_PreAns (217) function and 
their exemplary numeric values: 



Answer 


Value 


Explanation 


VOD_ANS_ACCEPT 
VOD_ANS_REJECT 
VOD__ANS_BUSY 
VOD_INS_NOANSWER 


OxOO 
0x01 
0x02 
0x03 


User has picked up and is accepting the call. 
User has rejected the call. 
Line is busy. 

User did not pick up within an acceptable time interval. 



VOD IP Status 



[0037] The following table illustrates symbolics for possible IP status values and their exemplary numeric values: 



Status 


Value 


Explanation 


STAT.FREE 


0 


This handle does not belong to any open item. 


STAT_C R EAT ED 


1 


The item's request is spawned and waiting to be handled (it is being processed). 


STAT.SENT 


2 


The item's request is being processed. 


STAT.READY 


3 


The item is ready to be connected (it is not already connected to any other 






Endpoint). 


STAT_CO NN ECTED 


4 


STAT_SENT 


Relevant only to an H.323 Endpoint 


STAT_H323_PROC 


10 


The Endpoint is in the call proceeding stage. 


STAT H323_ALERT 


11 


The Endpoint is in the call alerting stage. 


STATJH323_CONF 


12 


The Endpoint is in the call confirm stage. 



VOD Item Events 

[0038] The following table illustrates symbolics for possible VOD item events and their exemplary numeric values: 



Answer 


Value 


Explanation 


VOD_OREQ_HANGUP 
VODJDREQ ERROR 
VODJDREQ.STATUS 
VOD_OREQ_READY 


0x0120 
0x0121 
0X0122 
0x0123 


The user at the remote side of the H.323 Endpoint hung up. 

An error occurred for this item. 

The status of the item has changed. 

The status changed to READY for the first time. 



VOD Hangup Reasons 



[0039] The following table illustrates symbolics for possible VOD hangup reasons and their exemplary numeric val- 
ues: 





Value 


Hangup Code 


Reason Provided 


Explanation 




272 


H323_RES_ NORMAL 


Remote user hung up 


Normal call clearing 


50 








initiated by user. 




273 


H323_RES_ BUSY 


Remote station busy 


User busy. 




275 


H323_RES_ 


No answer 


Called user has been 






NOANSWER 




alerted but did not answer 


55 








within the timeout period. 


277 


H323_RES_ REJECTED 


Call rejected 


Called user rejected the 










call. 
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(continued) 





Value 


Hangup Code 


Reason Provided 


Explanation 




503 


H323__RES_ 


Not enough network 


The reservation of network 


5 




NO_NW_RSC 


resources 


resources failed. 




504 


H323_RES_ 


Not enough gatekeeper 


The gatekeeper does not 






NO_GK_RSC 


resources 


have enough resources to 
forward the call. 


10 


505 


H323_RES_ 


Destination unreachable 


The gateway could not 




U N R E ACH_D EST 




forward the call. 




506 


H323_RES_DEST_REJ 


Destination rejected 


The gateway forwarded 
the call, but the end user 
did not accept it. 


15 


507 


H323_RES_INV_REV 


Invalid revision 


Invalid software revision \ 








on the other side detected. 




508 

• 


H323_RES_NO_PERM 


No permission 


The Endpoint did not get 
the permission from the 
gatekeeper to accept the 


20 








call. 




509 


H323_RES_NCLGK 


Unreachable gateway. 


The gatekeeper could not 
be reached. 




510 


H323_RES_ 


Not enough gateway 


The gateway does not 






NO_GW_RSC 


resource 


have enough resources to 


25 








forward the call. 




511 


H323_RES_ 
BAD_FMT_ADDR 


Malformed address 


The gateway detected a 
bad format of the e.164 
number of the called user. 




512 


H323_RES_ 


Network overloaded 


The endpoint detected a 


30 




BAD_NO_QOS 




very low QOS that made 
the media connection 
unusable. 




267 


H323_RES_PROT_ERR 


Protocol error. 


A protocol error was 
detected or a 


35 








ReleaseComplete 
message with this reason 
was received. 




268 


H323_RES_ 


Unspecified hangup 


The local service provider 


40 




RELCOMP_UNSPEC 


reason 


got a ReleaseComplete 








message with a code it did 
not understand or was 
undefined. 




769 


H323_RES_ 


No control connection 


One of the control 


45 




CTRL_CNX_EST_FA I L 




connections could not be 








established within a given 
timeout. 




770 


H323_RES_ 
CTRL_CNX_LOST 


Control connection lost 


The control connection 
was unexpectedly lost. 


50 


771 


H323_RES_ 


Capability selection failed 


The capability selection 




CAPSEL_FAIL 




failed because no 
compatible set was found. 




772 


H323_RES_ 
TOO_MANY_CALLS 


Too many calls. 


The local service provider 
is not able to make a new 


55 








outgoing call because 
there are too many already. 
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(continued) 





Value 


Hangup Code 


Reason Provided 


Explanation 




773 H323_RES_ 




H323 implementat ion bug 


The local service provider 


5 


BUG_SP 






detected a software bug 










within itself. 




774H323_RES_ 




Application error 


The local service provider 




BUG_SU 






believes that the service 


10 








user is not conforming to 








the present specifications. 



Port Resource Control Custom Server (SPRC) Return Codes General Errors 



[0040] The following table illustrates symbolics for possible SPRC general errors and their exemplary numeric values: 

General Errors 

[0041] 





Error Code 


Value 




SPRC.SUCCESS 


0x00 




SPRC_GENERAL_FAILURE 


0x01 


25 


S P RC_I N VAL I D_PAR AM ETE R 


0x02 


SPRC_NOT_SUPPORTED 


0x03 




SPRC_ALREADY_IN_USE 


0x04 




SPRCJDUT_OF_RESOURCE 


0x05 




SPRC_OUT_OF_BOUNDS 


0x06 


30 


SPRC_NO_M EMORY 


0x07 




SPRCJTIMEOUT 


0x08 




SPRC_ADAPTERJMOT_FOUND 


0x09 



Shared Memory/Semaphore Errors 



[0042] The following table illustrates symbolics for possible SPRC shared memory/semaphore errors and their ex- 
emplary numeric values: 



40 



45 



Shared Memory/Semaphore Errors 


Error Code 


Value 


SPRCJJNABLEJDETTACH_SHM 


0x10 


SPRC_UNABLE_DESTROY_SHM 


0x11 


SPRC_UNABLE_ATTACH_SHM 


0x12 


SPRCJJNABLE_GET_SHM 


0x13 


SPRC_UNABLE_LOCK_SHM 


0x14 


SPRC_UNABLE_UNLOCK_SHM 


0x15 


1 S P RCJJ N ABL E_C R EATE_S HM 


0x16 


SPRC_UNABLE_GET_SHM 


0x17 


SP RC_U N ABLE_DESTRO Y_SHM 


0x18 



TDM Errors 

[0043] The following table illustrates symbolics for possible SPRC TDM errors and their exemplary numeric values: 
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TDM Errors 


Error Code 


Value 


SPRC_TDM_CONNECT_FAILURE 

SPRC_TDM_DISCONNECT_FAILURE 

SPRC_CONN_SERVER_NOT_READY 


0x1 A O 
0x1 B(*) 
0x1 C 



H Note: return codes marked with (*) have the 8-digft hexadecimal format Ox'bb'OOOO'aa' where: 
'aa' = Is the error code of the table above (in hexadecimal) 
■bb' = is the CA_ermo variable from DirectTalk (in hexadecimal) 



Connection Errors 



[0044] The following table illustrates symbolics for possible SPRC connection errors and their exemplary numeric 
15 values: 





Connection Errors 


Error Code 


Value 


20 


SPRC_CONNECTION_ERROR 


0x20 




SPRC_DISCONNECTION__ERROR 


0x21 




SPRC_DEALLOCATION_ERROR 


0x22 




S P RC_ALLO CATI O N_E R RO R 


0X23 


25 


S P RC_CON N ECTIO N_NOT_POSS I BLE 


0x24 


SPRC_DISCONNECTION_NOTPOSSBILE 


0X25 




SPRC_DEALLOCATION_NOTPOSSIBLE 


0x26 




SPRC_ALLOCATIONJnJOT_POSSB1LE 


0x27 




SPRC_INVALID_PEER_CARD_TYPE 


0x28 


30 


SPRCJNVALID_PEER_CARD_NUMBER 


0x29 




SPRC_PEER C HAN N EL_0 UT_0 F RAN G E 


0x2A 



Port Errors 



[0045] The following table illustrates symbolics for possible SPRC port errors and their exemplary numeric values: 



40 



Port Errors 


Error Code 


Value 


SPRC_PORTPIOT_YREE 
SPRC_PORT_NOT_OPENED 
SPRC_PORT_NOT_CONNECTED 


0x31 
0x32 
0x33 



45 Conference General Errors 

[0046] The following table illustrates symbolics for possible SPRC conference general errors and their exemplary 
numeric values: 



so 


Conference General Errors 


Error Code 


Value 




SPRC_CONFERENCE_ID_OUT_OF_RANGE 


0x40 




SPRC_NO_CONFERENCE_AVAILABLE 


0x41 


55 


SPRCJMULL_CONFERENCE 


0x42 
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Conference Queue Errors 

[0047] The following table illustrates symbolics for possible SPRC conference queue errors and their exemplary 
numeric values: 



5 





Conference Queue Errors 


Error Code 


Value 




S PRC_R EM OVE_FROM_AVAI L_M IX E R_QU EU E_E R ROR 


0x50 


10 


SPRC_REMOVE_FROM_USED_MIXER_QUEUE_ERROR 


0x51 




S PRC_REMOVE_FROM_B LOCK ED_MIXER_QUEUE_ER ROR 


0X52 




S P RC_AD D_TO_AVAI L_M IX E R_Q U EU E_E R ROR 


0x53 




SPRC_ADD_TO_USED_MIXER_QUEUE_ERROR 


0x54 


15 


SPRC_ADD_TO_BLOCKED_MIXERJJEUE_ERROR 


0x55 


S P RC_AD D_TO_AVAI L_CO N FE R EN C E_QU EU E_E R RO R 


0x56 




S P RC_AD D_TO_U S E D_CO N FER ENC E_Q U EU E_E R RO R 


0x57 



Mixer Errors 

20 

[0048] The following table illustrates symbolics for possible SPRC mixer errors and their exemplary numeric values: 



25 


Mixer Errors 


Error Code 


Value 




SPRC„MIXER_OUT_OF_RANGE 


0x60 




SPRC_MIXER_STATE_ERROR 


0x61 




S P RC_M I X ER_N OT_ALLOCATE D 


0x62 


30 


SPRC_MIXER_NOT_CONNECTED 


0x63 


SPRC_MIXER_NOT_FREE 


0x64 




SPRC_MIXER_NOT_BLOCKED 


0x65 




SPRC_NO_M I XE REALLOCATED 


0x66 




S P RC_NO_M I X ER_AVAI LAB LE 


0x67 


35 


SPRC_NO_M!XER_BLOCKED 


0x68 




SPRCJMULL_MIXER 


0x69 




SPRC_MIXER_CONNECTION_NOT_POSSIBLE 


0X6A 




SPRC_MIXER_ALLOCATION_NOT_POSSIBLE 


0x6B 




SPRC_MIXER_DISCONNECTION_NOT_POSSIBLE 


0x6C 


40 


SPRC_MIXER_DEALLOCATION_NOT_POSSIBLE 


0x6D 



EEC Errors 



[0049] The following table illustrates symbolics for possible SPRC EEC errors and their exemplary numeric values: 



50 



EEC Errors 


Error Code 


Value 


SPRC_EECJMOT_FOUND 


0x70 


SPRC_EEC_OUTj3F_RANGE 


0x71 


SPRCJNVALID_EEC 


0x72 


SPRCJ\IO_EECS_ALLOCATED 


0x73 


S P RC_E EC_N OT_ALLOCATED 


0x74 | 


SPRC_EEC_NOT_CONNECTED 


0x75 


SPRC_EEC_CONNECTED_NOT_FOUND 


0x76 | 


SPRC_NO_EECS^AVAILABLE 


0x77 \ 
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Wan Driver Errors 

[0050] The following table illustrates symbolics for possible SPRC Wan Driver errors and their exemplary numeric 
values; 

5 



10 



15 



25 



Wan Driver Errors 


Error Code 


Value 


SPRC_OSPJslUMBERS_UNMATCHED 


0x80 


SPRC_UNABLE_TO_OPEN_DEVICE 


0x81 


SPRC_ERROR_TRANSMIT_TO_WAN_DRIVER 


0x82 


SPRC_ERROR_RECEIVING_FROM_WAN_DRIVER 


0x83 


SPRCJNVALID_COMMANDFROIv_WAN_DRIVER 


0x84 


SPRC_UNMATCHED_COMMAND_FROM_WAN_DRIVER 


0X85 


SPRC_WAN_DRIVER_EEC_ALREADY_CONNECTED 


0x86 


SPRC_WAN_DRIVER_EEC_OUT_OF_RANGE 


0x87 


SPRC_WAN_DRIVER_MIXER_OUT_OF_RANGE 


0x88 


SPRC_WAN_DRIVERJNVALlD_COMMAND 


0x89 


SPRC_WAN„DRIVER_EEC_NC_TO^THE_MIXER 


0x8A 


SPRC_WAN^DRIVER_EEC_NC_TO^ANY_MIXER 


0X8B 


SPRC_WAN^DRIVER_IMPOSSIBLE_CONNECTION 


0x8C 


SPRC_WAN_DRIVER_UNKNOWN_RC 


0x8D 


SPRC_WAN_DRIVER_WAN_SID_ERROR 


0x8E 


S P RC_WA N__D RIVE R_WAN_R EG_E R RO R 


0x8F 


SPRC_WAN_DRIVER_WAN_RX_POLLED_ERROR 


0x90 


SPRC_WAN_DRIVER_WAN_WC_CONNECT_ERROR 


0x91 


SPRC_WAN_DRIVER_WAN_WC_CONCNF_ERROR 


0x92 



30 

DSP Errors 

[0051] The following table illustrates symbolics for possible SPRC DSP errors and their exemplary numeric values: 



35 



DSP Errors 


Error Code 


Value 


SPRC_DSP_OUT_OF_RANGE 


OxAO 



System Overview 

[0052] The present invention generally can be viewed in terms of the exemplary system architecture. This exemplary 
architecture comprises the following components: 

Voice-Over-Date (VOD) Components (201) 

[0053] 



1 VOD_Close (211); 
2VOD_Connect(212); 

3 VOD_GetCaps (213); 

4 VOD.GetGlobalEv (214); 

5 VOD_GetltemEvt (215); 

6 VOD_Net_CaII (216) ; 

7 VOD_Net_PreAns (217) ; 

8 VOD_Notify Event (218) ; 

9 VOD_Open__FPIay (219); and 
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1 0 VOD_Open_Port (220). 
Port Resource Control Custom Server (SPRC) Components (202) 
5 [0054] 

1 SPRC_Disc_SNID (221) 

2 SPRC_Open_SNID (222) 

10 State Table APIs Overview 
Concept of the APIs 

[0055] Since the basic functionality of the VOD Custom Server is to transfer voice (in real time) from several kinds 
of sources to several kinds of targets, the concept of the APIs is built of Endpoints and the connections between these 
Endpoints. The connections between the Endpoints have a particular direction that indicates the direction of the voice 
streaming. For example, to maintain a standard IP to PSTN phone call, one must open two Endpoints: an IP Endpoint 
and a PSTN Endpoint To enable voice between them (in both directions) two Endpoints need to be connected in full 
duplex mode. 

[0056] As another example, to record the PSTN side to a file, one must open the PSTN Endpoint (if it is not already 
open), and then open the file record Endpoint and connect the PSTN Endpoint to the record Endpoint in one direction 
(from PSTN to record) . A more complex structure can be created with the restriction that an Endpoint can only have 
one output connection and one input connection. 

[0057] The following describes the IBM Voice Over Data (VOD) and SPN256 Voice Over IP Port Resource Control 
(SPRC) state table APIs. They act as an interface between IBM's DirectTalk state Tables and the VOD/SPRC Custom 
Server API's. There are ten VOD state table APIs and two SPRC state table APIs 

Exemplary State Table API Usage 

30 PSTN Calls 

[0058] As illustrated in FIG. 3, when a call is received/made involving a PSTN port (300), the state table APIs used are: 

1 SPRC_Open_SNID (222) (301); and 
35 2 VOD_Open_Port (220) (302). 

[0059] When the call is completed (303), the state table APIs used to free the associated resources for the PSTN 
port are: 

40 1 VOD_Close (211) (304); and 

2 SPRC_Disc_SNID (221) (305). 

IP Calls 

45 [0060] As illustrated in FIG. 4, processing for inbound and outboud IP calls (400) is bifurcated (401). When a call is 
received involving an IP port (400), the state table APIs if the call is inbound (412) are: 

1 VOD_GetGlobalEv (214) (402) ; 

2 VOD_Net_PreAns (217) (403) ; and 
so 3 VOD_Notify Event (21 8) (404). 

[0061] In the case where a VOD connection is to be established for an agent or an outbound call (415) to an IP 
address is to be made, the state table APIs used are: 

55 1 VOD_GetCaps (213) (405); and 

2 VOD_Net_Call (21 6) (406). 
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Connecting Calls 

[0062] As illustrated in FIG. 5, when two parties are to be connected (500), the state table APIs used are: 
1 VOD_Notify Event (218) (501). 
5 [0063] When the call is completed (502), the state table APIs used to free the associated resources forth PSTN port 
are: 

1 VOD_Close(211)(503). 
Handle Status Notification 

10 

[0064] As illustrated in FIG. 6, the VOD API has the ability to notify the state table of activity concerning a particular 
'handle' (600). The state table APIs used to establish and use this function are: 

1 VOD_NotrfyEvent (218) (601) (this function may be called by or included in VOD_Connect (212) (611) and 
is VOD_Open_Port (220) (612)); and 

2 VOD_GetltemEvt (215) (602). 

ON-HOLD Transfers 

20 [0065] As illustrated in FIG. 7, here is an additional function that provides the ability to play a file to an endpoint (i. 
e. music, advertisement) (700). The file must first be opened and then connected to the 'handle' that will hear the file. 
The state table APIs used to perform this function are: 

1 VOD_Open_FPIay (219) (701); and 
25 2 VOD_Connect (212) (702). 

Exemplary Multi-Service System 

[0066] Referencing FIG. 8, the concepts presented in FIGs. 1-7 may be integrated such as to permit voice (801), 
30 telephonic information (802), as well as other types of multi-media data to be interfaced to a personal computer (803) 
over an IP network (804) to a PSTN gateway (805) that interfaces with one (806) or more (807) PSTN networks to a 
variety of remote communication system(s) (808, 809, 810) which may or may not have a structure similar to that of 
the IP/PSTN gateway of FIG. 8. This figure illustrates the generic capabilities of the present invention extend beyond 
simple voice communication and may be utilized in some environments to include a wide variety of data, including but 
35 not limited to voice, video, and other multi-media components. 

VOD State Table APIs 

VOD_Close(211) 

40 

Description 

[0067] This state table API will perform two functions: 

45 1 Disable notification (optional); and 

2 Close an item (endpoint/handle or connection) 

[0068] The state table will also do some preliminary checking of input parameters. If an input parameter is not valid, 
this state table API will return to the calling state table with a result of '1 ' and the 'Reason' field will contain information 
so about the invalid parameter. 

Input Parameters 

[0069] 

55 

VOD_Handle (number):the handle representing the endpoint or connection to be closed. Must be greater than 0. 
NotIfy_flag (string): Y or N to disable notification of handle status. If notification was turned on when the handle 
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was established, it should be turned off at this point. 
Output Parameters 
5 [0070] 

rc (number): return code from the Custom Server API. 

0 s successful. Refer to Exemplary Symbolics (VOD Return Codes) for details on all other return codes. 

10 Reason (string): if this state table returns to the calling state table with a RESULT = 1 (not 'Return code*), this 

field will contain one of the following errors: 

INVALID_HANDLE = the input parameter VOD Handle was less than or equal to 0. 

15 INVALID_NOTIFY_FLAG = the input parameter NotifyJIag was not Y or N VOD_Problem = the SendData or 

ReceiveData to the VOD custom server returned to this state table API with an unexpected state. 

INTERNAL_ERROR = the state table API had a system error (i.e. data mismatch, overflow, state table not 
invoked, etc.) 

20 

VOD_APIName (string): this field contains the name of the custom server API that returned the 'Return code' 
parameter value. This is mainly used for debugging when the state table API interacts with more than one custom 
server API 

25 VOD_Connect (212) 

Description 

[0071] This state table API will perform two functions: 

30 

1 Connects two endpoints/handles and starts the streaming between them. 

2 Turn notification on for the connected handle (optional) 

[0072] The state table will also do some preliminary checking of input parameters. If an input parameter is not valid, 
35 this state table API will return to the calling state table with a result of *1 ' and the 'Reason' field will contain information 
about the invalid parameter. 

Input Parameters 

40 [0073] 

Handlel (number): the handle representing one endpoint. Must be greater than 0. 
Handle2 (number): the handle representing the other endpoint. Must be greater than 0. 

45 

Streamed! r (number) : The direction of streaming where: 

1 = information goes from Handle 1 to Handle2 

2 = information goes from Handle2 to Handlel 

50 3 = streaming goes in both directions between Handlel and Handle2 

Notify_flag (string): Y or N to enable notification of handle status. 
Output Parameters 

55 

[0074] 

Connectjiandle (number): the handle representing the connection between the two endpoints/handles. 
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rc (number): return code from the Custom Server API 

0 = successful. Refer to Exemplary Symbolics (VOD Return Codes) for details on all other return codes. 

Reason (string): if this state table returns to the calling state table with a RESULT = 1 (not 'Return code 1 ), this 
5 field will contain one of the following errors: 

INVALID_HANDLE1= the input parameter Handle 1 was less than or equal to 0. 

INVALID_H AND LE2= the input parameter Handle2 was less than or equal to 0. 

10 

I N VA LID_N OTIF Y_FLAG = the input parameter NotifyJIag was not Y or N 

INVALID_STREAM_DIR = the input parameter Stream dir was not 1 , 2 or 3. 

15 VOD_Problem = the SendData or ReceiveData to the VOD custom server returned to this state table API with 

an unexpected state. 

INTERNAL_ERROR = the state table API had a system error (i.e. data mismatch, overflow, state table not 
invoked, etc.) 

20 

VOD_APIName (string): this field contains the name of the custom server API that returned the 'Return code' 
parameter value. This is mainly used for debugging when the state table API interacts with more than one custom 
server API 

25 VOD_GetCaps (213) 

Description 

[0075] This state table will get the currently configured 'CODEC 1 (coder/encoder) (also referred to as coder 
30 capabilities) . 

Input Parameters 

[0076] NONE 

35 

Output Parameters 
[0077] 

40 rc (number): return code from the Custom Server API 

0 = successful. Refer to Exemplary Symbolics (VOD Return Codes) for details on all other return codes. 

Reason (string): if this state table returns to the calling state table with a RESULT = t (not 'Return code'), this 
field will contain one of the following errors. 

45 

VOD_Problem = the SendData or ReceiveData to the VOD custom server returned to this state table API with 
an unexpected state. 

INTERNAL_ERROR = the state table API had a system enor (i.e. data mismatch, overflow, state table not 
50 invoked, etc.) 

VOD_API Name (string): this field contains the name of the custom server API that returned the 'Return code* 
parameter value. This is mainly used for debugging when the state table API interacts with more than one custom 
server API. 

55 

caps (number): configuration of tasks running in the SPN256 (for more details refer to the "VOD Custom Server 
APIs Users Guide" 
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VOD_GetGlobalEv (214) 
Description 

5 [0078] This state table API will poll for outbound request events. These requests indicate that some H.323 entity is 
trying to establish a connection to the gateway (is calling the application - for instance, an inbound call from an IP 
source). 

Input Parameters 

10 

[0079] NONE 
Output Parameters 
15 [0080] 

rc (number) : return code from the Custom Server API 

0 = successful. Refer to Exemplary Symbolics (VOD Return Codes) for details on all other return codes. 

20 Reason (string) : if this state table returns to the calling state table with a RESULT = 1 (not 'Return code'), this 

field will contain one of the following errors. 

VOD_Problem = the SendData or ReceiveData to the VOD custom server returned to this state table API with 
an unexpected state. 

25 

INTERNAL_ERROR = the state table API had a system error (i.e. data mismatch, overflow, state table not 
invoked, etc.) 

VOD_APIName (string): this field contains the name of the custom server API that returned the 'Return code' 
30 parameter value. This is mainly used for debugging when the state table API interacts with more than one custom 

server API 

Event JP/pe (number) :May be one of the following values: 

35 0 = no events (requests) present 

0x1110 = (int 65688) outbound call attempted 

Caller.uuid (number): 

40 Caller_H323 (number): 

CallerJP (string): IP address of the caller 

Caller number (string): the number of the PSTN call to be initiated. 

45 

VOD_GetttemEvt (215) 
Description 

so [0081] This state table API will get more information about an event that was reported to the calling state table via 
the 'WaitEvenf DT function. If an item did not send an event, but an event was posted, this can be used to poll the 
event's status. The state table will also do some preliminary checking of input parameters. If an input parameter is not 
valid, this state table API will return to the calling state table with a result of T and the 'Reason' field will contain 
information about the invalid parameter. 

55 

Input Parameters 

[0082] Handle (number): the handle to be used for the query of events. Must be greater than 0. 



17 



EP1 133 140 A2 



Output Parameters 
[0083] 

5 rc (number): return code from the Custom Server API 

0 = successful. Refer to Exemplary Symbolics (VOD Return Codes) for details on all other return codes. 

Reason (string): if this state table returns to the calling state table with a RESULT = 1 (not 'Return code*), this 
field will contain one of the following errors. 

10 

INVALID_HANDLE = the input parameter Handle was less than or equal to 0. 

VOD_Problem = the SendData or ReceiveData to the VOD custom server returned to this state table API with 
an unexpected state. 

15 

INTERNAL_ERROR = the state table API had a system error (i.e. data mismatch, overflow, state table not 
invoked, etc.) 

VOD_APIName (string): this field contains the name of the custom server API that returned the 'Return code' 
20 parameter value. This is mainly used for debugging when the state table API interacts with more than one custom 

server API. 

EventJType (number) : When no event has been received, this field = 0. Other values are: 
25 VOD_OREQ_HANGUP= (0x0120 = 288) the user at the remote side of the H.323 endpoint hung up. 

VOD_OREQ_ERROR = (0x01 21 = 289) an error occurred for this item. 
VOD_OREQ_STATUS= (0x01 22 = 290) the status of the item has changed. 

30 

VO D_p R EQ_RE ADY = (0x01 23 = 291 ) the status changed to READY for the first time. 
Eventjnfol (string): additional information pertaining to this event. 
35 EventJnfo2 (string): more information pertaining to this event. 

VOD_Net_Call(216) 
Description 

40 

[0084] This state table API will initiate an IP outgoing call. In the Call Center scenario, this is used when indication 
Is received that an outbound call is being initiated by an IP port via VOD_GetGlobalEv (214) (in other words, the 
initiating call is from an IP address and connection with them as the inbound caller must be established). When the 
handshaking is finished, the state of the handle will go into READY and an event will be sent. Therefore, in order to 
45 know the outcome of the API, the status of the handle needs to be polled using VOD JSetltemEvt (21 5) or wait for the 
event after issuing VODJMotify Event (218) and DT/6's Wait Event. The state table will also do some preliminary checking 
of input parameters. If an input parameter is not valid, this state table API will return to the calling state table with a 
result of '1' and the 'Reason' field will contain information about the invalid parameter. 

50 Input Parameters 

[0085] 

Dest_IP_ Address (string) :IP address of the party being called. Must not be blank. 

55 

Dest_Phone_Number (string): the phone number to be called when the party is a gateway. Leave blank, if party 
is not a gateway (i.e. agent). 
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Coder Caps (number) :the current CODEC of the SPN256. Refer to Exemplary Symbolics (Coder Capabilities) 
for expected values. 

Output Parameters 

[0086] 

rc (number): return code from the Custom Server API 

0 - successful. Refer to Exemplary Symbolics (VOD Return Codes) for details on all other return, codes. 

Reason (string): if this state table returns to the calling state table with a RESULT = 1 (not 'Return code'), this field 
will contain one of the following errors: 

INVALID JP_ADDRESS = the input parameter Dest_IP_Address was invalid. 

NOJP_AD DRESS = the input parameter DestJP_Address was blank. 

VOD_Problem = the SendData or ReceiveData to the VOD custom server returned to this state table API with 
an unexpected state. 

INTERNAL_ERROR = the state table API had a system error (i.e. data mismatch, overflow, state table not 
invoked, etc.) 

VOD_APIName (string): this field contains the name of the custom server API that returned the 'Return code 1 
parameter value. This is mainly used for debugging when the state table API interacts with more than one custom 
server API 



Handle (number): if the call is successful, the handle of this IP client endpoint. 
VOD_Net_PreAns (217) 
Description 

[0087] This state table API will confirm that a request was received for an outbound call and is being processed. The 
state table will also do some preliminary checking of input parameters. If an input parameter is not valid, this state table 
API will return to the calling state table with a result of '1 ' and the 'Reason' field will contain information about the invalid 
parameter. 

Input Parameters 

[0088] 

H323_Entry (number) :H.323 of the client (received from VOD_GetGlobalEv (214)). Must be greater than 0. 

Answer (number) : Possible values are Accept (0x00 = 0), Reject (0x01 = 1), Busy (0x02 = 2), No Answer (0x03 
= 3). Refer to Exemplary Symbolics (VOD_Net_PreAns (217) Possible Answers) for further details. 

Coder_Caps (number):the current COD EC of the SPN256. Refer to Exemplary Symbolics (Coder Capabilities) 
for expected values. 

Output Parameters 

[0089] 

rc (number): return code from the Custom Server API 

0 = successful. Refer to Exemplary Symbolics (VOD Return Codes) for details on all other return codes. 

Reason (string): if this state table returns to the calling state table with a RESULT = 1 (not 'Return code'), this 
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field will contain one of the following errors. 

INVALID_H323_ENTRY = the input parameter H323_Entry was not greater than 0. 

5 INVALID_ANSWER = the input parameter Answer was not greater than 0. 

VOD_Problem = the SendData or ReceiveData to the VOD custom server returned to this state table API with 
an unexpected state. 

10 INTERNAL.ERROR = the state table API had a system error (i.e. data mismatch, overflow, state table not 

invoked, etc.) 

VOD_APIName (string): this field contains the name of the custom server API that returned the 'Return code' 
parameter value. This is mainly used for debugging when the state table API interacts with more than one custom 
is server API 

Handle (number): if successful, the handle of this IP client endpoint. 

VOD_NotifyEvent (218) 

20 

Description 

[0090] This state table API will enable or disable notification to the DT state table of events concerning VOD 'handle'. 
Notification will be received by the DT 'WaitEvenf function, as a Host Event. Once the Host Event has been detected, 
25 the state table must issue VOD_GetltemEvt (215) to get details on the event. The state table will also do some pre- 
liminary checking of input parameters. If an input parameter is not valid, this state table API will return to the calling 
state table with a result of '1 ' and the 'Reason' field will contain information about the invalid parameter. 

Input Parameters 

30 

[0091] 

handle (number): handle for the endpoint for which event information is being retrieved. Must be greater than 0. 
35 Notify.f lag (string): 1 = enable, 0 = disable. 

Output Parameters 
[0092] 

40 

rc (number): return code from the Custom Server API 

0 = successful. Refer to Exemplary Symbolics (VOD Return Codes) for details on all other return codes. 

Reason (string): if this state table returns to the calling state table with a RESULT = 1 (not 'Return code'), this 
45 field will contain one of the following errors. 

INVALID_NOTIFY_FLAG = the input parameter Notifyjlag was not Y or N 

INVALID_HANDLE = the input parameter handle was not greater than 0. 

so 

VOD_Problem = the SendData or ReceiveData to the VOD custom server returned to this state table API with 
an unexpected state. 

INTERNAL_ERROR = the state table API had a system error (i.e. data mismatch, overflow, state table not 
55 invoked, etc.) 

VOD_APIName (string): this field contains the name of the custom server API that returned the 'Return code' 
parameter value. This is mainly used for debugging when the state table API Interacts with more than one custom 
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server API 

VOD_Open_FPIay (219) 
5 Description 

[0093] This state table API will open a specified file and send the voice message from this file to the connected 
endpoint/handle. The file content must be in the correct voice format that is used in the connected endpoint/handle. 
This does not play the file, but rather 'open' it to be played. In order to actually play the file, this state table API should 
10 be followed by VOD_Connect (212), to connect the handle received from this API to the handle of the endpoint that 
should hear this file. The state table will also do some preliminary checking of input parameters. If an input parameter 
is not valid, this state table API will return to the calling state table with a result of '1 ' and the 'Reason' field will contain 
information about the invalid parameter. 

is Input Parameters 

[0094] 

Flle_Name (string): the name of the file to be played. Must not be blank. 

20 

Loop_Flag (string): how to play the file. 

0 = play once 

1 = repeat continuously. 

25 

Coder.Caps (number) :the current CODEC of the SPN256. Refer to Exemplary Symbolics (Coder Capabili- 
ties) for expected values. 

Output Parameters 

30 

[0095] 

rc (number): return code from the Custom Server API 

0 = successful. Refer to Exemplary Symbolics (VOD Return Codes) for details on all other return codes. 

35 

Reason (string): if this state table returns to the calling state table with a RESULT = 1 (not 'Return code'), this 
field will contain one of the following errors. 

INVALlD__Fll_E_NAME = the input parameter File_Name was blank. 

40 

INVALID_LOOP_FLAG = the input parameter Loop_Flag was not 0 or 1 . 

VOD_Problem = the SendData or RecerveData to the VOD custom server returned to this state table API with 
an unexpected state. 

45 

INTERNAL_ERROR = the state table API had a system error (i.e. data mismatch, overflow, state table not 
invoked, etc.) 

VOD_APIName (string) : this field contains the name of the custom server API that returned the 'Return code' 
50 parameter value. This Is mainly used for debugging when the state table API interacts with more than one custom 

server API 

Handle (number): handle for this file endpoint. Will be used in the subsequent VOD_Connect. 
55 VOD_Open_Port (220) 
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Description 

[0096] This state table API will perform two functions: 

5 1 Open a connection to the telephone Interface card: opens a SNID with the appropriate number and all voice will 

pass through 

2 Turn notification on for the new handle (optional). The state table will also do some preliminary checking of input 
parameters. If an input parameter is not valid, this state table API will return to the calling state table with a result 
10 of T and the 'Reason' field will contain information about the invalid parameter. 

Input Parameters 

[0097] 

15 

snid (number) : the port number of the call on the telephony hardware interface card. This is gotten via 
SPRC_Open_SNID (222). Must be greater than 0. 

encoder (number): the output coder to the PSTN. Refer to Exemplary Symbolics (Coder Capabilities) for ex- 

20 pected values. 

decoder (number): the input coder from the PSTN. Refer to Exemplary Symbolics (Coder Capabilities) for 

expected values. 

25 Notlfy_YN (string): Y or N to enable notification of handle status. 

Output Parameters 
[0098] 

30 

rc (number): return code from the Custom Server API Refer to Exemplary Symbolics (VOD Return Codes) for 

details on all other return codes. 

Reason (string): if this state table returns to the calling state table with a RESULT = 1 (not 'Return code 1 ), this 
35 field will contain one of the following errors. 

INVALID_SNID = the input parameter snid was less than or equal to 0. 

I N VA LID__N OTIF Y_FLAG = the input parameter Notify YN was not Y or N 

40 

VOD_Problem = the SendData or ReceiveData to the VOD custom server returned to this state table API with 
an unexpected state. 

INTER NAL.ERROR = the state table API had a system error (i.e. data mismatch, overflow, state table not 
45 invoked, etc.) 

APIName (string): this field contains the name of the custom server API that returned the 'Return code' parameter 
value. This is mainly used for debugging when the state table API interacts with more than one custom server API 

so handle (number): the handle of this PSTN endpoint. 

SPRC_Disc_SNID (221) 

Description 

55 

[0099] This state table API will perform two functions: 

1 close the connection between an SPACK (DTQA) port set and an SPN256 port set. 
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2 close the SPN256 port set and deallocate the SPN256 port The state table will also do some preliminary checking 
of input parameters. If an input parameter is not valid, this state table API will return to the calling state table with 
a result of T and the 'Reason* field will contain information about the invalid parameter. 

5 Input Parameters 

[0100] 

dtqa__chan (number): the DTQA channel to be disconnected. Must be greater than 0. In DT, typically use system 
10 parameter SV 1 65: Channel number. 

snid (number) : SNID associated to the SPN256 port to be disconnected and deallocated. 

Output Parameters 

[0101] 



15 



20 



25 



30 



rc (number): return code from the Custom Server API 

0 = successful. Refer to Exemplary Symbolics (SPRC Return Codes) for details on all other return codes. 

Reason (string): if this state table returns to the calling state table with a RESULT = 1 (not 'Return code'), this 
field will contain one of the following errors. 

INVALID_SNID = the input parameter snid was less than or equal to 0. 

I N VA LID_DTQA_CH A N N EL= the input parameter dtqa chan was not greater than 0. 

SPRC_PROBLEM = the SendData or ReceiveData to the SPRC custom server returned to this state table 
API with an unexpected state. 

INTERNAL_ERROR = the state table API had a system error (i.e. data mismatch, overflow, state table not 
invoked, etc.) 

APIName (string): this field contains the name of the custom server API that returned the 'Return code 1 parameter 
35 value. This is mainly used for debugging when the state table API interacts with more than one custom server API 

SPRC_Open_SNtD (222) 

Description 

[01 02] This state table API will perform two functions: 

1 allocate a bidirectional port in the SPN256. 

45 2 connect an SPACK (DTQA) port set to a SPN256 port set. 

[01 03] The state table will also do some preliminary checking of input parameters. If an input parameter is not valid, 
this state table API will return to the calling state table with a result of '1 ' and the 'Reason' field will contain information 
about the invalid parameter. 

50 

Input Parameters 

[0104] dtqa_chan (number): DTQA channel where call arrived, to be connected to the SPN256 port. 

55 



40 
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Output Parameters 
[0105] 

5 rc (number) : return code from the Custom Server API 

0 = successful. Refer to Exemplary Symbolics (SPRC Return Codes) for details on all other return codes. 

Reason (string): If this state table returns to the calling state table with a RESULT = 1 (not 'Return code'), this 
field will contain one of the following errors. 

10 

INVALID_SNID = the input parameter snid was less than or equal to 0. 

INVALID_DTQA_CHANNEL= the input parameter dtqa_chan was not greater than 0. 

*5 SPRC_PROBLEM = the SendData or ReceiveData to the SPRC custom server returned to this state table 

API with an unexpected state. 

INTERNAL_ERROR = the state table API had a system error (i.e. data mismatch, overflow, state table not 
invoked, etc.) 

20 

APIName (string): this field contains the name of the custom server API that returned the 'Return code' parameter 
value. This is mainly used for debugging when the state table API interacts with more than one custom server API 

snid (number): SNID associated to the preallocated SPN256 port to be connected. 

25 

Method 

[0106] As described previously in reference to the flowcharts of FIGs. 3-7, the present invention may incorporate a 
variety of methods to implement the functions described herein. While the API flowcharts detailed previously are ex- 

30 emplary of a preferred method of implementation, one skilled in the art will readily be able to augment these teachings, 
and as such they are not limitive of the scope of the present invention. One skilled in the art will recognize that these 
steps may be rearranged and/or augmented with no loss of generality in the teachings of the present invention. 
[0107] The teachings of the present invention are sufficiently broad to not limit the manner in which the above- 
mentioned steps are to be performed as well as not limiting the method to any particular hardware, operating system, 

35 API, or graphical user interface. Thus, while the particular information gathered within the context of the flowcharts 
provided and the specific function calls listed in the exemplary flowcharts are preferred for some embodiments, they 
are by no means limitive of the present invention teachings or the scope thereof. 

Computer Software 

40 

[01 08] As would be known by one skilled in the art and as indicated In the exemplary embodiments of FIGs. 1 -8, the 
system and method described herein and generally illustrated in FIGs. 1-8 may be reduced to computer instruction 
codes and embodied on a computer readable storage means. This may take the form of a wide variety of storage 
media well known in the art and/or contemplated for future use. Thus, the present invention specifically anticipates the 
45 incorporation of the system and methods discussed herein in the form of tangible computer software products. 

[01 09] Furthermore, while not limiting the scope of the present invention, the present invention specifically anticipates 
that one or more components of the present invention may be implemented using the AIX®operating environment in 
all its variations or its equivalent commercial embodiments, including but not limited to any system incorporating a 
graphical user interface. 

50 

CONCLUSION 

[0110] A multi-service communication system and method has been disclosed which permits the integration of tra- 
ditional PSTN functions and voice-over-IP/voice-over-data (VOIP/VOD) functions within the same communication sys- 
55 tern. The extension of scripting functions to support these features in general simultaneously permits the script to 
interact with PSTN and IP telephones within the context of the same services, to share the same service logic for both 
PSTN and IP media, to conference participants on both PSTN and IP, to store and forward information between the 
two media, to play on -hold media to the interface, and/or to monitor information between the two media. In general the 



24 



EP1 133 140 A2 



disclosed invention is amenable to the integration of PSTN and VOIP networks, but other service functions may be 
integrated with no loss of generality. 



5 Claims 

1 . A multi-service communication system comprising: 
a PSTN interface means; 

10 

a PSTN gateway client application means; 
an IP interface means; 
15 wherein 

said PSTN gateway means permits uni-directional and/or bi-directional communication between said PSTN 
interface means and said IP interface means. 

20 2. The multi-service communication system of Claim 1 wherein said PSTN gateway means further comprises: 

(a) a VOD_Close means; 

(b) a VOD_Connect means; 

25 

(c) a VOD_GetCaps means; 

(d) a VOD_GetGlobaIEv means; 
30 (e) a VOD_GetltemEvt means; 

(f) a VOD_Close means; 

(g) a VOD_Net_CaII means; 

35 

(h) a VODJMet_PreAns means; 

(i) a VOD_Notify Event means; 

40 (j) a VOD_Open_FPIay means; and 

( k) a VOD_Open_Po rt means . 
3. The multi-service communication system of Claim 1 or 2 wherein said PSTN gateway means further comprises: 

45 

(a) a SPRC__Disc_SN1D means; and 

(b) a SPRC_Open_SNID means. 

so 4. The multi-service communication system of any of the claims 1 to 3 wherein one or more components of said 
system is implemented within an application programming interface (API). 

5. The multi-service communication system of any of the claims 1 to 3 wherein said communication occurs between 
PC-to-phone endpoints. 

55 

6. The multi-service communication system of any of the claims 1 to 3 wherein said communication occurs between 
phone-to-PC endpoints. 
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7. The mufti-service communication system of any of the claims 1 to 3 wherein said communication occurs between 
phone-to-phone endpoints. 

8. The multi-service communication system of any of the claims 1 to 3 wherein one or more components of said 
5 system is implemented on a multi-services server. 

9. The multi-service communication system of Claim 8 wherein said multi-services server utilizes a graphical user 
interface. 

10 1 o. The multi-service communication system of Claim 9 wherein said graphical user interface utilizes a AIX®operating 
environment. 

11. A multi-service communication method comprising: 

15 processing PSTN calls with a PSTN call processing process means; 

processing IP calls with an IP call processing process means; 

processing connecting calls with a connecting call processing process means; 

processing handle status notifications with a handle status notification processing process means; 

processing ON-HOLD calls with an ON-HOLD call processing process means. 
20 wherein 

said processing may be performed synchronously and/or asynchronously. 

12. The multi-service communication method of Claim 11 wherein said PSTN call processing step further comprises: 
25 activating a SPRC_Open_SNID process means; 

activating a VOD_Open_Port process means; 
waiting for call completion; 

30 

activating a VOD_Close process means; and 
activating a SPRC_Disc_SNID process means. 
35 13. The multi-service communication method of Claim 11 or 12 wherein said IP call processing step further comprises: 
determining if said call is outbound, and if so, proceeding to step (5); 
activating a VOD_Get_GlobalEv process means; 

40 

activating a VODJMet_PreAns process means; 
activating a VOD_Notify Event process means and 
45 terminating processing; 

activating a VOD_GetCaps process means; and 

activating a VOD_Net_Call process means and terminating processing. 

50 

14. The multi-service communication method of any of the claims 11 to 13 wherein said connecting call processing 
step further comprises: 

activating a VODJMotifyEvent process means; 

55 

waiting for call completion; and 
activating a VOD_Close process means. 
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15. The multi-service communication method of any of the claims 11 to 14 wherein said handle status notification 
processing step further comprises: 

activating a VODJMotify Event process means either singly and/or in response to requests from a 
5 VOD_Connect process means and/or a VOD_Open_Port process means; and 

activating a VOD_GetltemEvt process means. 

16. The multi-service communication method of any of claims 11 to 15 wherein said ON-HOLD call processing step 
10 further comprises: 

activating a VOD_Open_FPIay process means; 

activating a VOD_Connect process means; and 

15 

waiting for call completion. 

17. The multi-service communication method of any of claims 11 to 16 wherein one or more steps of said method is 
Implemented within an application programming interface (API). 

20 

18. The multi-service communication method of any of claims 11 to 16 wherein said communication occurs between 
PC-to-phone endpoints. 

19. The multi-service communication method of any of claims 11 to 16 wherein said communication occurs between 
25 phone-to-PC endpoints. 

20. The multi-service communication method of any of claims 11 to 16 wherein said communication occurs between 
, phone-to-phone endpoints. 

30 21 . The multi-service communication method of any of claims 1 1 to 1 6 wherein one or more steps is implemented on 
a multi-services server. 

22. The multi-service communication method of Claim 21 wherein said multi-services server utilizes a graphical user 
interface. 

35 

23. The multi-service communication method of Claim 22 wherein said graphical user interface utilizes a AIX®operating 
environment. 

24. A computer program product comprising programming code instructions for executing the steps of the method of 
40 any of claims 11 to 23 when said program is executed on a computer. 

25. A computer usable medium encoding executable instructions which when executed on a computer carry out the 
method of any of claims 11 to 23. 

45 



50 



55 



27 



EP1 133 140 A2 




28 



EP 1 133 140 A2 



PSTN Gateway API 

200 



VOD 

220 

f 201 


r 2n 




VOD_Open_Port 




VOD_Net_PreAns 






f 216 




VOD.GetCaps 


\ 


VOD.NetCall 




212 




^ 218 






VOD_Connect 


OPTIONAL 


VOD_NotifyEvent 










^ 214 




219 




VOD.GetGlobalEv 




VOD_Open_FPIay 




215 






VOD_GetltemEvt 




VOD.Close 













221 



SPRC Disc SNID 



SPRC 

202 



222 



SPRC_Open_SNlD 



FIG. 2 



29 



EP1 133 140 A2 



C 



300 



START 
PSTN CAUL 
PROCESSING 



301 



SPRC_Open_SNID 



302 



VOD_Open_Port 



303- 



CALL NO 
COMPLETE 
? 



YES 



304 



VOD_Close 




- r 


SPRC_Disc_SNID 







305 



( DONE ) 



FIG. 3 



30 



EP1 133 140 A2 



400 



(START 
IP CALL ) 
PROCESSING J 




401 

412*. \" \ s 4l - 

CALL 



402 



VODGetGlobalEv 



403 



VOD.Net^PreAns 



Z 



404 



VOD.NotifyEvent 



407 



^ DONE ^ 



Z 



405 



VOD_G 


etCaps 




r 




VODJS 


let_Call 



406 



FIG. 4 



31 



EP 1 133 140 A2 




VOD.CIose 



j S 504 



G5D 



FIG. 5 



32 



EP 1 133 140 A2 



START 
HANDLE STATUS 
NOTIFICATION 
PROCESSING 



611 



US A 
)N ) 



601 



612 



VOD_Connect 


► 


VOD_NotifyEvent 




VOD_Open_Port 




< 








y 602 

r f 








VOD_GelltemEvt 










1 









^ DONE ^ 



FIG. 6 



33 



EP1 133 140 A2 




VOD_Open_FPIay 




FIG. 7 



34 



EP1 133 140 A2 



800 

^803 




REMOTE 
COMMUNICATION 
SYSTEM(S) 



FIG. 8 



35 



